package cn.tedu.pdfamily.product.repo;

import cn.tedu.pdfamily.product.pojo.vo.RoleListItemVO;
import cn.tedu.pdfamily.product.pojo.vo.RoleStandardVO;

import java.util.List;

/**
 * 处理用户缓存的数据访问接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
public interface IRoleRedisRepository {

    /**
     * 用户数据项在Redis中的Key前缀
     */
    String ROLE_ITEM_KEY_PREFIX = "role:item:";
    /**
     * 用户列表在Redis中的Key
     */
    String ROLE_LIST_KEY = "role:list";
    /**
     * 所有用户数据项的Key
     */
    String ROLE_ITEM_KEYS_KEY = "role:item-keys";

    /**
     * 向Redis中写入用户数据
     *
     * @param roleStandardVO 用户数据
     */
    void save(RoleStandardVO roleStandardVO);

    /**
     * 向Redis中写入用户列表
     *
     * @param roles 用户列表
     */
    void save(List<RoleListItemVO> roles);

    /**
     * 删除Redis中全部用户数据，包括各用户详情数据和用户列表等
     *
     * @return 成功删除的数据的数量
     */
    Long deleteAll();

    /**
     * 从Redis中读取用户数据
     *
     * @param id 用户id
     * @return 匹配的用户数据，如果没有匹配的数据，则返回null
     */
    RoleStandardVO get(Long id);

    /**
     * 从Redis中读取用户列表
     *
     * @return 用户列表
     */
    List<RoleListItemVO> list();

    /**
     * 从Redis中读取用户列表
     *
     * @param start 读取数据的起始下标
     * @param end   读取数据的截止下标
     * @return 用户列表
     */
    List<RoleListItemVO> list(long start, long end);
}
